iT邦幫忙

2026 iThome 鐵人賽

DAY 3
0
Modern Web

WebMCP:30 天打造 AI Agent 看得懂、也操作得動的網站系列 第 3

Day 03|你搜尋到的 WebMCP 可能不是同一套:Chrome、W3C、webmcp.dev 一次分清楚

  • 分享至 

  • xImage
  •  

本篇重點

目前搜尋 WebMCP 很容易把不同來源混在一起。這個系列以 Chrome 官方實作文件 + WebMCP Web Machine Learning Community Group Draft 為技術基準;webmcp.com 用來觀察生態案例;webmcp.dev 則視為另一套社群實作與延伸方案,不直接等同官方 WebMCP API。

這一篇看似只是整理名詞,但其實非常重要,因為 API 寫錯一套,整個系列都會跟著錯。

先講最容易踩的坑

你可能在一篇文章看到:

document.modelContext.registerTool(...)

又在另一個網站看到 Resources、Prompts、Sampling,然後開始懷疑:

WebMCP 到底有沒有完整 MCP 的 Resources/Prompts?

答案是:先確認你看的到底是哪一個專案。

1. Chrome for Developers

這是我這系列最主要的實作參考。

目前 Chrome 官方把 WebMCP 分成:

  • Overview / Agents
  • Imperative API
  • Declarative API
  • Security guidance
  • Evals / best practices 等相關內容

Imperative API 的核心入口是:

document.modelContext

主要會碰到:

registerTool()
getTools()
executeTool()

以及 toolchange event、AbortSignalexposedTo 等功能。

官方頁面也明確標示 WebMCP 處於 Origin Trial/實驗階段,因此文章發佈時一定要保留「規格可能變動」的提醒。

2. WebMCP Community Group Draft

2026 年 9 月的 Draft 位於:

https://webmachinelearning.github.io/webmcp/

這是 Web Machine Learning Community Group 發布的 Draft Community Group Report。

要注意一件事:Community Group Report 不是 W3C Recommendation,也不是 W3C Standards Track 的正式標準。

所以我在文章裡會避免寫成:

WebMCP 已經是 W3C 正式標準。

比較精確的寫法是:

WebMCP 目前由 Web Machine Learning Community Group 推進規格草案,Chrome 也正在進行實驗性實作。

這個差異很重要。

3. webmcp.com

webmcp.com 比較適合用來看生態與案例。

對我來說它的價值是:如果只看 Specification,很容易一直停在「API 能做什麼」;看實際網站的 Tool 類型,則會開始思考:

  • 電商網站真正值得提供哪些 Tools?
  • Travel 類網站會怎麼拆能力?
  • Developer Tool 類網站又會提供什麼?

所以 Tool Design 的案例可以參考它,但不把它當成 API 規格來源。

4. webmcp.dev

webmcp.dev 則提供另一個社群方向的 WebMCP 實作與 Bridge 概念,內容會提到 Tools 之外的 Resources、Prompts、Sampling 等能力。

這些內容有研究價值,但不要直接拿它的 API 去解釋 Chrome 的 document.modelContext 規格

最安全的做法就是:

Chrome / Community Draft
→ 本系列主線

webmcp.com
→ 生態與案例

webmcp.dev
→ 延伸研究

本系列的「版本政策」

因為這是 30 天連載,最大風險是 Day 03 寫的 API 到 Day 25 已經改掉。

所以我會固定做三件事:

  1. 程式碼優先對 Chrome 官方文件。
  2. 行為/權限細節再對 Community Draft。
  3. 每篇涉及實驗 API 時標記文章撰寫日期與可能變更。

如果官方文件和 Draft 有差異,我會以「瀏覽器現在實際提供什麼」和「規格現在怎麼定義」分開說,不硬把它們當成完全同步。

一張表記住

來源 我怎麼用 適不適合當 API 依據
Chrome for Developers Chrome 實作、範例、Origin Trial ✅ 主力
WebMCP Community Draft API 定義、權限模型、事件 ✅ 主力
webmcp.com 生態與案例 △ 案例
webmcp.dev 社群實作與延伸 △ 另外研究

可帶走的重點

  1. 搜尋 WebMCP 時先看來源,不要看到同名就當同一套 API。
  2. 本系列採 Chrome + Community Group Draft 為主。
  3. WebMCP 目前仍是實驗性規格,不應寫成已完成的 Web 標準。
  4. 社群方案值得看,但要明確區分定位。

參考資料


上一篇
Day 02|MCP 已經能接工具,WebMCP 到底多了什麼?一張圖拆開兩者責任
下一篇
Day 04|WebMCP 跑不起來先別怪程式:Chrome 開發環境與 5 個常見坑
系列文
WebMCP:30 天打造 AI Agent 看得懂、也操作得動的網站13
圖片
  熱門推薦
圖片
{{ item.channelVendor }} | {{ item.webinarstarted }} |
{{ formatDate(item.duration) }}
直播中

尚未有邦友留言

立即登入留言